home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / rnet107u.zip / RNETCONF.DOC < prev    next >
Text File  |  1991-01-03  |  12KB  |  246 lines
  1.  
  2.  
  3. ───────────────────────────────────────────────────────────────────────────────
  4.      PROCONF.EXE  --  Convert ProDoor 2.9+ CONFINFO to RNet 1.05+ RNETCONF
  5.      PCBCONF.EXE  --  Convert PCBoard 14.x CNAMES   to RNet 1.05+ RNETCONF
  6. ───────────────────────────────────────────────────────────────────────────────
  7.  
  8.                 ***  REQUIRED READING FOR RNET OPERATION!  ***
  9.  
  10.      ProConf and PCBConf are part of the RNet Echo Conference package.
  11.   ProConf (or PCBConf) is *required* for proper support of the RNet 1.05+
  12.   extended conferences.  Neither of these utilities were required for
  13.   previous versions of RNet as earlier versions did not use RNETCONF.
  14.  
  15.      Through ProConf.exe, PCBConf.exe, and the file they both produce,
  16.   RNETCONF, RNet can now support up to 32,767 conferences (32 THOUSAND
  17.   conferences!) via either a ProDoor or PCBoard system.  ProDoor 3.2
  18.   currently supports 2,040 conferences while PCBoard 14.5 supports 65,534
  19.   conferences.  If anyone needs more than 32,767, just drop me a line.
  20.  
  21.      As of alpha version 1.05B of RNet, this new conference support has been
  22.   tested for 3,001 conferences.
  23.  
  24.      RNETCONF is a fixed length (80 byte) file listing the conference name,
  25.   messagebase location+name, number of message NDX blocks (as CHR[x]), and
  26.   flags (also as a CHR[x]).  There is expansion space left which may be used
  27.   for "automatic" packing options for RNet to run when drive space gets close
  28.   to full.
  29.  
  30.      RNETCONF *can* be edited using a standard text editor (such as QEdit or
  31.   Edlin).  There is a "x" placed at column 78 (plus the CR and LF make 80
  32.   bytes) as a place holder.  If you edit this file make sure that the "x"
  33.   stays in column 78 or the file will be corrupted!  Also, if your text
  34.   editor does not automatically strip trailing spaces be sure to remove them
  35.   manually from following the "x".  By being able to edit this file it gives
  36.   you the ability to change messagebase locations, names, echo flags, or
  37.   even add conferences to the RNet system without any fuss or dependance on
  38.   PCBoard/ProDoor.  All the conference specific information RNet needs is
  39.   stored in this file.
  40.  
  41.      ProConf and PCBConf will overwrite any information in RNETCONF if run
  42.   with the -i switch or if the RNETCONF file is older than CONFINFO and/or
  43.   CNAMES (depending on if running ProConf or PCBConf).
  44.  
  45.      ProConf and PCBConf should not be distributed seperatly from the RNet
  46.   package as they are not of much use without it.  Though, if you like
  47.   writing automated QEdit macros like I do, you can use the RNETCONF file to
  48.   produce PACKALL.BAT files and other useful things.
  49.  
  50.  
  51.  
  52.  
  53.  
  54. PROCONF.EXE   Support for ProDoor 2.9+ CONFINFO       [for use with RNet 1.05+]
  55. ───────────────────────────────────────────────────────────────────────────────
  56.  
  57.      ProConf is designed to read a ProDoor 2.9 CONFINFO file and produce the
  58.   needed RNETCONF file for RNet to use.  It will automatically check the
  59.   time/date on your CONFINFO file to determine if it needs to run.  Unless
  60.   you have specifically edited your RNETCONF file, you can safely call
  61.   ProConf during your mail event, usually just before calling RNet.exe.
  62.  
  63.      There are two valid commandline sequences available:
  64.  
  65.   │  d:\dir\PROCONF.exe d:\doors\prodoor\CONFINFO d:\rnet\RNETCONF [-i]
  66.   │
  67.   │  Please note that the complete name (path+name) is required for
  68.   │  CONFINFO.  If you specify anything for RNETCONF, it must be the
  69.   │  complete name (path+file).  If do not specify the RNETCONF file,
  70.   │  ProConf will be create RNETCONF in the current directory.
  71.  
  72.   │  d:\dir\PROCONF.exe %confinfo% d:\rnet\RNETCONF [-i]
  73.   │
  74.   │  The "%" character (or any word which starts with the "%" character,
  75.   │  such as "%confinfo%") tells ProConf to get the name and location of
  76.   │  your CONFINFO from the "CONFINFO=" environment variable.  If you
  77.   │  specify RNETCONF, you must include the entire path and filename.  If
  78.   │  you do not specify RNETCONF, it will be written to the current drive
  79.   │  and directory as RNETCONF.
  80.  
  81.      ProConf accepts the -i (or /i) commandline switch, which you may
  82.   specify anywhere on the commandline.  The -i switch tells ProConf to
  83.   ignore the time/date stamps on your CONFINFO and RNETCONF files and
  84.   *always* execute.  Think of -i as "ignore time/date".
  85.  
  86.      If you specify -i, or if ProConf determines it needs to run based on
  87.   the time/date stamps, you will be displayed a fancy screen showing the
  88.   status and operation (which will not last long). When ProConf is done, it
  89.   will restore your screen and exit.
  90.  
  91.      You may use -m (monochrome), -b (bios), and -c (cga snow) switches to
  92.   modify ProConf's screen operations.  ProConf *should* detect most every
  93.   type of display, but these switches are provided for you if it does not.
  94.   ProConf does, of course, support 25, 30, 43, 50, 60, and 66 line screens -
  95.   the more lines you have, the more information you can see.
  96.  
  97.      If ProConf encounters any problems or errors, it will display an error
  98.   message, the errorlevel, and any other information it thinks might help.
  99.  
  100.  
  101.  
  102.  
  103.  
  104. PCBCONF.EXE   Support for PCBoard 14.x CNAMES         [for use with RNet 1.05+]
  105. ───────────────────────────────────────────────────────────────────────────────
  106.  
  107.      PCBConf is designed to read a PCBoard 14.x CNAMES file and produce the
  108.   needed RNETCONF file for RNet.  As with ProConf, PCBConf automatically
  109.   checks the time/date on your RNETCONF and CNAMES files to determine if it
  110.   needs to run.  Unless you have specifically edited your RNETCONF file, you
  111.   can safely call PCBConf during your mail event, usually just before
  112.   calling RNet.exe.
  113.  
  114.      Commandline sequence:
  115.  
  116.   │  d:\dir\PCBCONF.exe d:\pcb\main\CNAMES d:\rnet\RNETCONF [-i]
  117.   │
  118.   │  Please note that the complete name (path+name) is required for CNAMES.
  119.   │  If you specify anything for RNETCONF, it must be the complete name
  120.   │  (path+filename).  If do not specify the RNETCONF file, PCBConf will be
  121.   │  create RNETCONF in the current directory.
  122.  
  123.      The -i (or /i) commandline switch tells PCBConf to ignore the time/date
  124.   stamps on your CNAMES and RNETCONF files and thus *always* execute.  Think
  125.   of -i as "ignore time/date".
  126.  
  127.      If you specify -i, or if PCBConf determines it needs to run based on
  128.   the time/date stamps, you will be displayed a fancy screen showing the
  129.   status and operation.  When PCBConf has completed its task it will restore
  130.   your screen and exit.
  131.  
  132.      You may use -m (monochrome), -b (bios), and -c (cga snow) switches to
  133.   modify PCBConf's screen operations.  PCBConf *should* detect most every
  134.   type of display, but these switches are provided for you if it does not.
  135.   PCBConf supports 25, 30, 43, 50, 60, and 66 line screens - the more lines,
  136.   the more information you will be able to see at once.
  137.  
  138.      If ProConf encounters any problems or errors, it will display an error
  139.   message, the errorlevel, and any other information it thinks might help.
  140.  
  141.      As long as Clark Development simply extends the CNAMES file in the
  142.   upcoming PCBoard 14.5, you should be able to use PCBConf to support all of
  143.   the 'extended' (above 39) conferences seamlessly.
  144.  
  145.  
  146.  
  147.  
  148.  
  149. PROCONF/PCBCONF Installation and Operation            [for use with RNet 1.05+]
  150. ───────────────────────────────────────────────────────────────────────────────
  151.  
  152.      The first thing you need to do is pick which (ProConf or PCBConf)
  153.   utility you will be using.  If you currently have a ProDoor system
  154.   installed which supports CONFINFO, I recommend that.  Because CONFINFO is
  155.   a fixed length file it is much more difficult for ProConf to get "out of
  156.   alignment" compared to the ASCII free-form text format of CNAMES.  Place
  157.   the selected utility (or both) in your RNet directory.
  158.  
  159.      Run the selected utility to verify its operation.  If you are using
  160.   ProConf, specify the name+location of your CONFINFO file and name+location
  161.   of the RNETCONF file to create.  If you are using PCBConf, specify the
  162.   name+location of your CNAMES file then the name+location of the RNETCONF
  163.   file to create.
  164.  
  165.      RNet *MUST* find a RNETCONF file in the current directory, or a file
  166.   pointed to by RNETCONF= environment variable, for it to operate.  I
  167.   recommend simply placing 'RNETCONF' in the directory you normally run RNet
  168.   from and avoid using the precious environment space.  The environment
  169.   support is added for ease of "multiple-pass" execution of RNet or if
  170.   running a multi-node system with inconsistent drives/paths between nodes.
  171.  
  172.      After successful execution of ProConf/PCBConf, 'TYPE' the resulting
  173.   file or load it into a text processor (such as QEdit or Edlin).  You
  174.   should be able to easily determine if something is wrong by the 'columns'
  175.   not lining up or things looking real strange.  Ignore the "smilies" or
  176.   other characters see about column 43-45 as they are bit-flags -- DON'T
  177.   change, move, or delete them!
  178.  
  179.      The following is optional.  NOTE: If you do not implement this, you
  180.   will have to manually run ProConf/PCBConf to update RNETCONF to reflect
  181.   any changes you make to CONFINFO or CNAMES!  I suggest using the
  182.   following:
  183.  
  184.         In your MAILRUN.BAT (or whatever batch file you use to automate
  185.      your RNet operations), add a ProConf or PCBConf line just before
  186.      calling RNet. Specify everything that ProConf/PCBConf needs to
  187.      properly read CONFINFO or CNAMES and write RNETCONF where it needs
  188.      to go.  Both utilities will automatically check the time/date on
  189.      their respective files to determine if they need to update
  190.      RNETCONF.  You can 'force' either of these utilities to operate by
  191.      using the -i switch.  If you need to set any of the display control
  192.      switches, don't forget them.
  193.  
  194.      You may add a line such as "RUN=PROCONF %CONFINFO% D:\RNET\RNETCONF" to
  195.      your HOST.CFG file.  This will instruct RNET to automatically shell and
  196.      run PROCONF (or anything else) when it is setting up.
  197.  
  198.      Simply type RNET with no commandline and verify that RNet can find your
  199.   RNETCONF file.  RNet will display a warning and abort if it cannot find
  200.   RNETCONF.
  201.  
  202.      Make a manual mailrun (at least RNET EXPORT BBS_ID) to verify that RNet
  203.   is operating correctly.  You may delete your BBS_ID.REP packet when done
  204.   and simply 'COPY BBS_ID.SAV BBS_ID.PTR' to restore your pointers.
  205.  
  206.      If you have any problems please drop me a note on Faster-Than-Light,
  207.   404-292-8761/299-3930 [USR1440];  The Right Place 404-476-2607 [USR1440];
  208.   ILink Sysops, Offline, MM-RNet; or RIME Sysops conferences.
  209.  
  210.  
  211.  
  212.  
  213. ───────────────────────────────────────────────────────────────────────────────
  214.   Version change notes for PROCONF and PCBCONF  (latest changes are on top)
  215.  
  216. (both)
  217. ------- -----------------------------------------------------------------------
  218.  1.00c  Tue  06-26-1990
  219.  
  220.         Changed both utilities to check the filename length for the message-
  221.         base.  Since ???SM may create a base filename with over 8 characters
  222.         and RNET would find this in error, this is forced.  An example of a
  223.         bad filename would be "ECHOTESTING" (11 characters) which will be
  224.         corrected into "ECHOTEST" (8 characters, the actual DOS limitation).
  225.  
  226. PROCONF
  227. ------- -----------------------------------------------------------------------
  228.  1.00b  Mon  04-02-1990
  229.  
  230.         Corrected bug which read the wrong field for "Make All Messages R/O"
  231.  
  232.         Corrected a bug which resulted in ProConf not reading the last
  233.         conference from CONFINFO.
  234.  
  235. PCBCONF
  236. ------- -----------------------------------------------------------------------
  237.  1.00b  Mon  04-02-1990
  238.  
  239.         Added alignment checking by checking the DLPATH.LST file for each
  240.         conference.  PCBCONF will abort with ERRORLEVEL==6 if it gets out of
  241.         alignment or if DLPATH.LST does not exist for any given conference.
  242.  
  243.         Corrected PCBCONF to properly read PCBoard version 14.5 CNAMES.
  244.  
  245.  
  246.